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The MIDAS Linking Loader is a PDP-6 program to load relocatable- 
format output from the MIDAS assembler, with facilities to handle 
symbolic cross-references between independently assembled programs. 
Although it Is arranged primarily to load from DECtape, the loader is 
able also to load paper-tape relocatable, programs. 

To use the loader, load it off the MACDMP SVSTEM tape as the file STINK . 
(A file STISK NEW may exist, repairing old bugs or introducing new 
features,) Then the loader expects commands to be typed in on the on* 
line '.teletype; two successive ALT MODE characters terminate the string 
of commands* The commands in a string are not performed until the string 
is thus terminated. While a command string has not been terminated, 
RUBOUT will erase the last typed-in character (and type it out again as 
a reminder). A command string may contain any number of commands, and 
the effect is the same whether the commands are together in one string 
or arc in successively typed-in strings each delimited by two ALT MODEs . 

Th6 loader maintains two tables whose contents may change as programs 
are loaded: (a) the Loader Table, which contains definitions of global 
symbols and unresolved virtual usages; (b) the local symbol table, 
containing all program names, and the local symbols for each program 
for which their loading was requested* 



In the following command descriptions, n is an octal 
the command characters said to have a value. '§ is 
echoes out a$ 5 • u represents SPACE . 



number, or one of 
ALT MODE, which 



command form 



Me a n i n£ 



nMname 1^ nara 2 



Set to read from the paper tape reader. -(Tape must 
be in the reader, and the reader must be on 
when this command is performed.) 

Set to read from beginning of file nam&l name? on 

DECtape unit n . (If n is omitted, the last 
DECtape mentioned ' is assumed.) 

Load selected input file without local symbols. 
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Load selected Input file, saving local symbol definitions 
for DDT. (N and L set Che Current Starting 
Address to that specified in the progrem 
loaded If that is not 0.) 

Copy all defined global symbols In the Loader Takle 
Into the local symbol table (ior DDT); then 
dslete same from the Loader Table. 

Read In the relocatable version of DDT from DECtape 
unit 1, tell it of all symbols in the local 
symbol table; wipe out the loader and transfer 
control to DDT, 

List files of DECtape unit n , <As in the H corvnand, 
the argument n may be omitted.} 

Transfer control to the Current Starting Addreas. 

Set the Current Starting Address to n and transfer 
control thereto. 

Frint the value of fl m$ an octal Integer. 

Has the value of the Current Starting Address, 

Has the value of the lowest address currently used 
by the loader* ■■ 

Delete all local and global aymbols from the locel 
symbol table and the Loader Table, 

Zero core except registers 20 through 37 and th* loader 
(from E up). 

Print contents of location n ■ 

Has the current value of program relocation* 

Set program relocation to ?,_ ■ 

Set cocoon relocation to r. . 

Print storage map: Each program in core has one line 
in the map. At the left is the program name, 
and at the right in octal is a word whose 
right half is the first location used by the 
program and vhose left half is the lest 
location used by the program. 



) 
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* a Print storage map and missing list (short form) * Each 

program loaded appears as follows: one line ■ 
with Che program name at the left and the first 
address used by the program at the right; any 
number of lines Indented one space, each Hating 
an undefined symbol used in that program, with 
" the address of its first use therein. Symbols 

are global unless preceded by * meaning local. 

n ? Print storage map and missing List (long form). (Here 

the value of n is immaterial, but an argument 
must be given.} Like ? with the following 
changes: (a) following the program name is a 
36-bit word in octal with first and last addresses 
as for the S command; (b) the address is given 
of each reference to each undefined symbol. 

n<ayra> Define symbol eym with the value ri , The symbol will be 

global unless a * is typed somewhere between 
< and > ■ 



Error message meaning 

Storage capacity exceeded. The program being Cloadcc 
5CE aar collided with the loader at adr . 

VGA adr sym Undefined global assignment. The global symbol syn 

was undefined when needed by the loader to 
perform a parameter assignment or location 
assignment. The current loading address is 

MDG adr sym Multiply defined global. A defined global appeared to 

the left of a : when adr , the current location, 

did not equal the value of the global. It was 
B2L redefined, 

CKS Checksum error. 

FHF File not found on DECtape specified. 

THS num Too much symbols: occurs when loading DDT, and means 

that DDT + symbols + program exceeds storage 
available by num registers. 

ILM Illegal memory reference: an error by the loader. 
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A cape labelled LIBRARY is available, containing various useful sub- 
routines in Che file LIBRAR 1 ■ Up-to-date details arc posted In the 
PDP-6 room. Each program in the library file was assembled with the 
• LIBRA pscudoinstructlon, and so will be loaded only if in the Loader 
Tabic is a request for a global symbol defined in that program. There- 
fore the library file should not be loaded until all programs have been 
loaded which make reference to the library subroutines* 

Command string Examples. 

(al) To load the program APLHA RALPIIA from DECcape unip 3, the program 
SUBR 1 from unit 2, and the program BR from unit 2; then to 
get a storage map and missing list; 

"■-■ 3MALPhV^RALPHA©L2MSUBRol©L^UBR^(|)L?0(|) 

In this example, L was used for each program to load its local 
symbols* The K command could have been used in each case instead 
not to load local symbols. 

(a2) Then Co go to DTT: 
TDl^ 



(b) To load the program in the paper-tape reader and transfer to its 
starting address; 

PNG©© 

The L command was not used here because DDT was not requested. 

(c) To load PROG REL from DECtape unit 1 and the requested library 
routines from unit k\ 

1KPR0C^REL@ UMLIBRAR^ (|)N©(D 



♦ 
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HIDAS is a PDP-6 assembly pro* ran. Its input is * *ymboIlc-langud S e file 

-b.. .« papac t . p . .233 1B ASCII „ de , „ . £- ct . p , 4SC „.„ od „ £1U | I 

according to the MAC file format (••« MAC-M-249). The output of MIDAS If :■ % 
a binary file - either a paper tape o. a SBLK or RELOC-mode file on DECta^ 
The input language i', format-fr.^ waning that the value or use of a word > 
la tha input does not depend on its position In a line or on the page, but I.'",' 
iwtead upon the characters (such as colon, comma, and carriage return) which 
d.limitit. 
■ the ou. PU t of MIDAS con SisCa pri „ arlly Bt stora8g „ ord .. 36 . Wt ^^^^ 

Also in 



•"W-DOT-BM-FP-ACTM and A.I. Memo. Bo. 147, »A Multiple Procedure DDT") 
The programmer .nay seUct* on, of several formats for his b inary output; fa . 1 
;.*f them, rslocatobU^Uowa him to nake symbolic cross-references between 
independently assembled programa. 

- - ■ ■.-:■ ■ ■ ■-. -- --- ■:■■■ ■-■---■'; ' : 



i"«ncr 




Th, MM .^Ue Wag e prov?dcs ■■■, y£ verU - 

" '""" """""" ° £ '"""" » &» •• »»-« **<« ,„ struc : io „ 5 , 

integer » any , £ ,.„„tW M ., H„ tlng point number „ h . 1£ . word?> ch „ acter 
«r, W . etc. In ad a iC1 o n « haa a „ clety 0( fe . ture , ( ^ _„ [h>ttuctIons 
..- i^t. « P . ac) t „ iub8titution a „ d repltitlon of charjceer ^^^^ 

comprising input to MIDAS, 
^original specification^ 

by ™bers of the Tech Model Railroad Club, in c!udIng i&fc Fraii?f , Cwnb ^ 
Gro... Hollovay, Kotok, N.Uon, Eggers and Samson. Since then, mo s t. of ch, H$ ' 
-ork on th. assembler has been done by Mr. Creenblatt who i, now M na, ing the 
» a .nc.„ an c. .„, WopMt olmDAS . Ih . cor „ 8ponding po>itio „ teiarding 

the MIDAS linking load.r is held by Mr, Hollovay. 



. 



-3- 



SYHTAX OF CHARACTERS 
Appearing ir. Value Words 



A,B ,V,Z 

0,1 8,9 



ignored except to separate dummy symbol names 



syllable constituents 



■ n 






intra* syllable operators 



syllable separators 



/ 
# 

? 



field separators 



word terminators 



the symbol A will be 
used to star.d for sny 
single field separator 

the symbol 2 will b£ 
used to stand for any 
one character of the 
set cr»lf ,ff t vt 



( ) 
<> 



fu. 



delimit syllable from without; 
delimit word within 

indirect bit; (p may appear anywhere in a word 



The elementary unit of meaning in MTDAS is the syllabic. Depending upon its 
form and upon how it was defined, a syllable may be a number , a symbol , a 
macro name , a gscudoingtruction , a quoted characte r , or one of several kinds 
f bracketed word . A pseudoinstructior. directs so©e action on the part of 
MIDAS; a macro name stands for a string of characters; other syllables (termed 
valued syllables ) represent nuraeric quantities, which are 36 bits in si2e. 
Such a quantity is the value of the syllable. Associated with each valued 
syllable is a relocation: a quantity which is either or 1 • The value of 
seme syllables may be virtual , oeaning the value is not known at assembly 
time but will become known as the program is loaded. Virtual quantities have 
a relocation of 0. 









NUM3KRS 



A string of digits forms an integer with its expressed numeric value and 
relocation. The number is interpreted in the current radix . An integer 
ended by ' (single quote) is however taken as in base 8; and an integer ended 
by . (period) is taken in base 10. An integer may be followed by T followed 

by an integer: 

A ♦ B, where A and B are integers, means the integer ( 

m 

A * R with R being the radix in which A is expressed. 
A string of digits with . (period) to the left of some digit is a floating-point 
number : decimal radix is assumed. A floating-point number may be followed by 



t ii 



integer, and the result is a floating point number: e.g 



: e.ft. 3.5 f 4 






means the 



■ 



. 



. 




■ 



same as 350USJ.0 . Any of these numeric formats may be followed by 4- integer, 
which multiplies the current value by 2°"^ L .. (The exponent integer nay 

be terminated by * or * to force its radix; otherwise it used the current radix.) 
The result is a fixed-point integer! For instance, 1*5 4r 3 ■ 14'; and 

17" *- 3 - 170'. 



SYMBOLS 

A string of syllable constituents, which includes at least one letter, or at 
least one S or ^i , or at least two * (periods), or which consists of the 
single character . (period) is a name. Only the first six characters of a 
name are used by the assembler, A name may be defined as a symbol, a macro 
namet or a pseudoinstruction, A symbol is 4 valued syllable. 

One may write syllablei <- syllable2 which takes syllable.? as an integer 
which may not be virtual, and must have relocation; the expression means 
syllablei* 2* ylUWe2 . If either syllable contains any operators whatsoever 

it must be a bracketed word. If syllablei is virtual, or has (^relocation, 

13 
the value of svilable 2 must be less than 2 . 

■ 

- 
If the character ! (single quote) appears to the right of a character in a 

symbol, it declares that symbol to be a variable . MIDAS forms a list of 

distinct variables, which become defined, at the first subsequent use of the 

pseudoinstruction VARIAB or END, as unique memory locations. . 

■ 

i -■ 

If " (double quote) follows any character in a symbol, it declares that symbol 

> * * 

global . If a global symbol is NOT defined in the program where it appears its 



■ ■ ■■■ . 

■ 

. ■ • 

value is virtual , to be supplied by the loader. If a global sycbol is defined 



in the program, its value is passed on to the loader and there oay resolve 
virtual quantities in other programs. 

. AND $.; THE CURRENT LOCATION 



- 



MIDAS maintains an 18-bit quantity {with 1-bit relocation) called the current 
location counter . Its value, is that address into which the next storage word 
will be assembled. The current location may be set by use of the pseudoinstruction 
LOC; it is advanced by i. with each storage word assembled, and by some amount 
at each use of the pseudoinstructions BLOCK, COKSTA, VARIAB and END. By use 
of LOC the current location may become virtual. 

MIDAS also aaintains the offset : a 36-bit- ^-relocation quantity. This 
normally has value (S, relocation but may be set otherwise by ths OFFSET 
pseudoinstruction. 

The symbol . (period) always has the value (and relocation) of Current 
Location plus Offset. For instance (assuming offset - 9) * In ADD [SUB .] 
the . refers to the location of the ADD, not that of the SUB. 

The symbol $." is virtual. It is the address where the loader is about to 
put a storage word. So in ADD tSUB $•"] (regardless of any offset) the $." 
haa the value of the location where the SUB is to be put. 

The virtual symbol $R." stands for the leader relocation, i.e. the anount that 
the loader adds to the value of each quantity (including the location counter) 



which has a relocation of ± m 












- . 
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If '(single quote) or "{double quote) or Hup arrow) appears without 

a syllable constituent immediately to its left* the quote (or arrow) and the 

character Immediately to its right are token as a syllable with the 

value of the aixbitjor ASCII code, or ASCII anded with 77° t for the 

character, respectively- e.g., f A means 41'; "+ means 53'> +Q mean* 21', 









— 



TED WORDS 



<wtd> 

(word) 






[word] 












is a syllable with the value of word , where word is a word. 
If the ( is immediately preceded by a syllable-separating 

character, is a syllable whose value is word , the value of 
word with left and right halves swapped* 

is a constant syllable , and word in this case is called a 
constant word . As MIDAS assembles a program it forms a list 
o£ distinct constant words, and at the appearance of the 
pscudoinstruction COKSTA or END a number of locations is 
reserved equal to the number of constant words outstanding. 
Each constant word is assembled to appear in a unique one of 
these locations. Then, each constant syllable which refers 
to a certain constant word is given the value of the address 
of that constant word. Last, the table of constant words 
is reset to contain none* 



-8- 



FIELDS 

A valued syllable is a field; and two or pore valued syllables may be combined 
to form a field by means of the syllable separators + - * / \ # and ^ * 

These perform respectively 36-bit integer operations of addition, subtraction, 

■ 

multiplication, division (will truncate quotient) and bitwise Boolean 0R> 
XOR, and AKD. All £/s are performed first, then all d*'s, then Vs, then all 
*'s and /'«; Last, + and - , Operators of the same hierarchy are performed in 
order from left to right. 

WORDS 

One or more fields connected by field separators form a word * The two field 
separators are space (or horizontal tab), and coewna. (Space and h.tab are 
synonymous and will both be called spaces.) Spaces before and after a word 
are ignored* More than one space in a row are treated as one. Spaces adjacent 
to a cocoa are ignored. 

The values of the fields are combined to form the value of the word according 
to the number of fields and the pattern of field separators, as detailed in 
the following chart. 






: 

FORMAT TABLE 



FORMAT 1ABLE 

(A, B and C stand for fields) 

■ 










» 



fomat number 
in octal 



pattern 






value 









13 
14 
15 
16 
17 
20 
21 
22 
23 
24 

25 
26 
27 
30 
31 
32 
33 
34 
35 
36 
37 



The sign 



>>C 

.A 

.AwC 

,A, 
,A,C 

A 






} 



unaligned 
A & 777777 

unassigned 

A 






! 



not possible 



A w B 

A W B W C 

A w B, 

A ^B.C 

A. 

not possible 

A,, 

A,,C 

A.B 

A,B wC 

A.B, 

A.B.C 



A fr B & 777777 

AfBB &777777 © C ^777777 

A + <B & 17> <— 23. 

A + <B & 17> <— 23. £ C £ 777777 



<A & 777777 > <— 18. 

<A 4 777777 > «i- 18. + C ^ 777777 

A B e\ 777777 



] 



unassigned 



- 



■ 



■ 
) means addition with carry suppressed from bit 18 to bit 17. 

■ 

■ . . 



• 



In the case o£ four or more fields in a word, the first three ere treated 

■ 
according to the chart and all subsequent fields, regardless of separators > 



are treated like field C. 



If in a word appears (word) wich the character to the left of the ( other 
than + - * / \ fl or J , the swapped value of the word within the parentheses 
is saved and at the end of the outer word is added into the word being formed. 





■ 




■ 














Anywhere in a word may appear the character (Jy . The ONtY effect of this is 
that when the word has been evaluated, the indirect bit. If 22., is ORed 
into the value. The fi docs not terminate syllables or fields, nor is it taken 
part of a syllable or field. 



Certain symbols form the MIDAS initial symbol table . Any of these which represent 
PDP-6 machine instructions (except the 8 I-o instructions) may be independently 
defined by the programmer, in which case both values are available to MIDAS. 
When the symbol appears in the leftmost field of a word it assumes the initial 
value; otherwise^ the new value* 



■ 



KORD USES 



*: 






■ 



. 






nane: 



nace s word ^ 
name ■■wo rd^ 



. ■ 



makes name a symbol with value > relocation and 
virtuality equal to those of the Current Location. 

m£kes name a symbol with value, relocation and 
virtuality of word . 



is namejiordA , but also has the effect, when 
the symbol table is read by DDT, of "half-killing" 
the symbol name in DOT's symbol table. 



■ 

■ 






■ 



.■ 






■ 



■ 





' 






word is taken as a storage word 



(a series of A characters with no intervening 
word creates no storage words and does not change 
the Current Location Center. 



word; text If 



word is taken as a storage word* and. the text froa 
the ; to the first Line feed is ignored. 



NOTE: If i or ; terminates a word it automatically closes all open ([ 
and <groupings. Hence ADD^[(3 £ is the same as ADD^[(3)] ^ , 



PSEUPOKSTRidXQNS FART X 



Any arguments supplied to. the following pseudoinstructions in excess of 
those needed arc ignored* 



LOC A word ^ 



BLOCK £* word 1 



■ ' 



sets the Current Location Counter to the right 
18 bits of the value of word , with the relocation 
and virtuality of word* 

sets the Current Location Counter to the right 
18 bits of the sum of its previous value and the 
value of word. 



E2*D ^ word d 



XWORD & field! A field2£. 
XWD &> fieldl A field2^ 

EXP A word J- 



This marks the end of the program, and the right 
18 bits of the value of the word, and its relocation, 
are saved as the program starting address. The ESD 
also acts as VARIAS and CONSTA, in thst order, if 
there are any constant words or variables undefined. 



Same as (, fieldl ),field2 



Same as word^ 






■ 



•OP & fieldl A field2 A fleld3£ This is a syllable and so may have syllable- 
combining operators to its left and at the 
right of the last A . The value of the 
syllable is the result of performing fieldl 
«$ 4 PDP-6 instruction with field2 in the 









■ 
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OCTAL 

DECIMAL 

RADIX £ word J 

COUSTA^ 

VARIAB i 

SULL^ 

EQUALS Anamel & name? j^ 



TITLE £ string l£^ 



specified accumulator and field3 in the 
specified memory location. The value of 
.OP is the resulting contents of the 
accumulator. 

Sets current radix to 8 

Sets current radix to 10. 

Sets current radix to value of word. 

Reserves space where it appears for all 
unas signed constant words. 

Reserves space where it appears for all 
undefined variables. 

has no effect. Any number of arguments 
may be given and' will have no effect. 

namel is raade a synonym of name 2 and may 
be used anywhere instead of nawe2 + This 
pscudoinstruction is generally used upon 

macros and pseudoinstructions rather than 
symbols. 

The string of characters through the first 
line feed is the title of the program, and 
is printed out when the TITLE pseudoinstrucnion 
is encountered on each pass of the assembly. 
The program name , which may be used fay DDT, 
is set to the first 6 characters of Che 
first syllable in the title. 



OFFSET A word^ 



The Offset 
of word. 



is set to the value and relocation 



SQUOZE C field, symbol 



ASCII ^j jtcxtj 



Is a syllable with value equal to the cadix-50 
representation of symbol plus £ field t 17 > 4-30, 

where ^ is any ASCII character, and text is 
any string of ASCII characters not containing 
X*. generates one or more storage words, 
containing each five 7-bit characters ^f the 
text, from left to right left-justified in 
successive words (in order chat can be read 
with ILDB). If j, is a syllable, field, or 



























■ 



. 
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' 















. 






word- separator other then space! the space 
after ASCII can be omitted. The entire 
usage is treated as a syllable: any 
syllable-combining operators at its left 
act upon the first storage word it 
generates* and any syllable-combining 
operators co its right act upon the last 
storage word it generates. 









ASCISwjtextj 



like ASCII , but if number of 
text is divisible by 5 r as 
additional storage word of 



characters 
les final 



In 



.ASCII jtoxtj 



like ASCIS; but also when the 
encountered in the text takes 
following it, evaluates that 
the character string representing 



character ! is 
the field 
field* creates 
that value 



in octal digits, and puts that 
string into the assembled text 
instead of the ! and field. 



character 
storage words 



SIXBITMJtextj 



Same action a; 
characters to 



ASCII, but puti 
the word* 



six sixbit 



.PNAM1) 
.FNA-M2J 



In time-sharing version only .7KAM1 and 
• FNAM2 correspond respectively to the sixbit 
code for the first and second sub name a of the 
source file (see Operating Instructions). 
For example, if the source file name is 
RAtfDOM PROG, .FNAMl has the saoe numeric 
value as SIXBIT /RANDOM/ . 



PRINTC^jtextj 



Takes a text argument identical in form to 
that of ASCII, and prints the text on-line 
when the pseudoinstruction is met on each 
pass of the assembly. No storage words are 
created. 



PRINTX-Jtextj 



Same as PRINTC, but 
of the character ! 



suppresses type-out 



EXPCNG Anamel Aname2 A , . ,Anamen) 



Each name is expunged . 
the symbol table; and 
by MIDAS. 



i.e., deleted from 
effectively forgotten 



w. 



.END£, f 



CON I 


field], 


field2J 


CONO 


fleldl. 


field2i 


CONSZ 


field]. 


field2j 


COHSO 


field], 


field2i 


DATAI 


fieldj. 


field2; 


DATAO 


field! , 


field2) 


B1XI 


fieldl, 


field2i 


BUO 


field) . 


field2,i 


forcat number 




In 


octal 

26 
27 





N 



; 



the code appearing between .BEGIN and Its 
matching ,ESD is termed a program block 
(not to be confused with a DECtape block, 
a logical block of assembler output, or 
a group of locations spaced over by the 
BLOCK pseudoinatruction). All symbol 
definition* effected within a program 
block are "undone" at the -END, and such 
symbols regain the values they had at the 
.BEGIN. Program blocks may be nested. 

Th* eight PDP-6 i-o instructions are defined 
as psecdoinstrustions to'MIDAS. If chey 
appear in the leftmost field of a word, then 
for that word the evaluation rules for 
certain word formats changes according to 
the following table; and the i-o Instruction 
otherwise szts as a symbol with the value 
shown in the Initial Symbol Table. 



pattern 



A wE, 
A W B, C 



valu< 



A 
A 



< 
< 



& 177 > «-26. 

& 177> 4- 26. ec£777777 



.FORMA A ne, fi 



Inserts an entry in the format table (i.e.* 
replaces old entry) for format number no 
(see format table on Page 9). The tumeric 
value of field fs is taken as three 12-bit 
bytes referring to the (up to) three distinctly 
handled fields in a word: the left 12 bits 
refer to the right most field, the middle 
12 bits to the field next to the right most 
(if any) and the right 12 bits to the field 
2 from the right and any additonal fields. 
(If there is only one field in a given format 
it is the right most regardless of punctuation 
which may be required after it.) 
A 12-bit byte describing a particular field 
is in turn treated as two 6-bit bytes. The 
right 6-bit byte specifies a mask and the 
left 6-bit byte specifies a shift. The mask 
number (say m) directs that only the right 
m bits of the field value be taking the shift 
number (say s) directs that the bits 



remaining after masking be shifted 
The fields, after this masking and 
are added to give the value of the 
(Example: the 12-bit specification 
describes an accumulator field: 

<f&17> 



left £ bit; 
shifting 
word. 
27« 8 

23. 



15. 



There are three exceptions to the above 
procedure. (1) If a field is specified 
as 0022g (right half, not shifted) the 
carry out of bit 18 is suppressed as the 
field is added into the word. (2) A 
virtual quantity oay only occur in a field 
specified 0044 8 , 0022g, 2222e, 0504g or 
27048- O) If as a syllable in the left- 
most field of a word appears any of the 
eight i-o instructions (DATAO, DATAJ, 
CONO, C0N1, BLKC, BLKJ, CONSZ, CONSO) 
then any field in that word specified 
2704a '* instead taken as If specified 
3211 8 (i-o device field). 



.LEHGT jtextj 



(text argument as 
syllable with the 
characters in the 



for ASCII) this is a 
value of the number of 
text. 



.TYPE name 



is a syllable whose value depends on the 
nature (at that point) of the name name. 



value (octal) 
1 

2 

3 

4 
-" 
6 
7 
10 

11 

17 



if name is a 

pseudoinstruction or macroname 
defined symbol (not global , 

not a variable) 
undefined local symbol 
defined local variable 
undefined local variable 
defined global variable 
undefined global variable 
defined global symbol (not a 

variable) 
undefined global symbol (not 

a variable) 
unseen (except in .TYPE) 
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?ft£i:i)3 INSTRUCTIONS PAST II* 



The foregoing sections described chose features of the MIDAS language which 
(AtMTtlly) handle numeric value*; these features should be sufficient co the 
casual user, and adequate for a majority of KIDAS-language programs. The 
following sections describe the character-string-handiing feature or MIDAS, 
primarily macroinstructions, REPEAT and IRP (indefinite repeat). MIDAS takes 
each usage of such pseudo- or macroinstructions and translates that string of 
characters into a new character string (according to ch« rules below) which i 
fed back as input to MI3AS- (See sketch) 



LS 



results of 
macros $c repeats 



ASCII 
input 



■TmidasJ 



binary 
-^ output 



RE?£A? A field A text cr 



REPEAT & field A [text] 



(where text is any character string whose 
first character is not E and which contains 
no cr) MIDAS detects this pseudoinstruccion, 
determines the numeric value of jield (as an 
integer), say n; and passes text bazk as inpul 
a total of n tioes, followed each time by 

Finds Rj the value of field ; then passes 
£**£ Co the input n times. The £<-y.c_ r.ay 
contain any characters including [endj; the 
] which delimits the text is the first that 
matches the opening f 9 No extra characters 
are passed on. The (outermost) brackets 
surrounding text are not passed on. 
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,BPC»t 



This ts a symbol whose value depends on 
the innermost repeat in which it is 
contained; the first tine that repeat 
is processed* *XPCKT has the value 0; 
the second time, it has the valued ; etc, 



The following pseudoinstructions, whose names begin IP, are termed conditional 
assembly pseudoinstructions. 



IFiA textcr 
IFi£ [text! 



IF2 
IF2 



& cextc_r > 
A [text} J 



IFE 4 field A textcr 
IFE A field £ [text] 




IFSE A string i &s:ring2 £ textcr J 
IFSE iJstringl & string2 £ Uext] ) 



IFSH 



IRPA A, B a [P, Q, R]ji 



(take text argument like that of SE?2AT.) 
The text is passed back as input if the 
assembler is performing Pass ± . Otherwise 
this usage gives no characters out. 

Like IF1, but gives text back to input*'only 
if performing Pass 2, 

If the numeric value of field is equal Co £, 
the text is reprocessed as input; otherwise not, 



Identical to I7E in form; pass text back 
according as the value of their first 
argument is: greater than; greater than 
or equal to; not equal to; less .than; less 
than or equal to: 0» respectively. 



(text argument as in REPEAT,) The strings 
are compared charactcr-for-character. 
Each string may contain spaces and commas 
if its first character is open bracket {[)* 
in which case that string is ended by the 
catching close bracket (1). Such outermost 



LU 



brackets , 


if tl 


:ey exist j are not used 


in 


the string comparison. The text is tfc 


ten 


processed 


only 


if the two fields are 




identical 


character strings* 




Like IFSE; 


i but 


passes text on only if 


the 


two fields are 


not identical strings. 





The IRP pseudoinst ruction takes a triolet of 
arguments > separated by commas: the first 
two are names > called dummy symbols ; the third 
is termed 2 list . Each of the dummy symbol 
names need not be given. The list consists 
of an open bracket, any number of elements 



i 





■ 









separated by commas, and a closed bracket* 
Each element is a string of zero or more 
characters and lists. The only character 
excluded is corona; and that nay appear if 
in 4 list, i.e. inside I ]. For instance: 
1RP Hi. , lAX,BY,[C f D,Eh J has Hi its 
first dumny symbol , has no second dummy 
symbol, and has a list of five elements : 
AX; BY; [C,D»E]; and two null arguments. 



TERM IK £ 



The ran^e of an IRP is the string of 
characters from that IRP to the next 
matching TERMIN, exclusive* The effect 
of IRP-TERMIH is to pass the range of 
the IRP on as input' again a number of 
times equal to the number of elements in 
the list of the IRP. The first tirac 
through the range, the first dummy symbol 
of „ the IRP has the string value of the 
first element of the list, meaning that: 
appearance of that dummy symbol Inside the 
range (terminated at each end by 1 or any 
non-syllable-constituent) is replaced 
(in effect) by the current string value of 
the dueny symbol. The second tine through 
the range, the first dumay symbol has the 
string value of the second element of the 
list* etc. 



Example: IRP A, , [Wl ,W2,W4] 
ADD 3, A 
TERMIN 

will recirculate the string 



ADD 


3, 


Ml 


ADD 


3, 


W2 


ADD 


3, 


W4 









The second dummy symbol of tRP has,' on 
each iteration through the range, the 
string value of the remainder of the list 
yet unused: for instance, on the third 
iteration of IRP Q,R,[ASD, IOR,X0R,EQV, 
AHDCAl for R would be substituted EQV, ANDCA. 



■ 



■ 






IRP A,B,[X,Y,ZK:,D,[P,Q,R]E,F,lS,T,tJ] ...£ 












■ ■ 









■ 



' 



The IRP pseudolns -ruction may be followed 

by any number of triplets. At each iteration. 






. 









19. 



IRPC i A, B, [string] ^ 



all the dutaay symbols are advanced in their 
respective lists* The IRP iterates a 
number of limes equal to the number of 
elecc&ncs in the longest list; if one list 
id exhausted before another, both i:s dumoy 
syabcls receive null string valuta. 

Here A and B are dummy symbols, and string 
is 3 string of characters ended by the 
first matching ]• On each iteration of 
the :RPC i:he first dummy symbol takes the 
string value of each successive character 
in s::ring » and the second dummy symbol has 
the string value oi the string to the right 
of chat character. In all other resects 
IRPC is u$ed identically to IRP, 

IftPS &A,B,[syll ^ syl2 7... vsyln] Agsift A and B sre dunsny symbols; v £*■ 

any field or syllable separator. On each 
iteration the first duzmy syebol has che stria 
value of successively each of the gyl i * and th 
second dummy symbol has the string value of th 
^7 to the right of the syllable which is the 
current value of Che first diramy symbol. Othe 
wise IRPS is like IRP and IRPC. 

MACRO INSTRUCTIONS 

A pac rains i rue c ion definition is a syntactic element consisting of: a define line; 

a definition body; and the pseudoinstrxiettoo TERXXN* 



A define line contains in order: the pseudoinstruction DEFINE; a nacae, which 
is co be defined, called the mac ro na;no ; and zero or more names which are dummy 
symbols; all separated by spaces or commas, except that a dummy symbol may be 
preceded or terminated by / or \ instead; the whole extending through the firsc 
£ character, but if that character is cr and the next character is If, the If 
also is taken as part of the define line. 



2Q. 



The definition .body is all text following the define line, up to but not 
including the first unmatched use of TERHIN* (The TERMIN pseudolnstruction is 
matched by IKP, IRPC, IRPS and DEFD1E-) 

The effect of a macroinstruction definition is that when its TERMIM is encountered 
the macro name becomes defined as a macroinstruction with the string value of the 
definition body. 

As this happens, the characters to the left and right of each dummy 
symbol occurrence in the body are examined: each one which is an exclamation 
point is deleted and its place taken by a siark which is invisible; except 
that it delltalnaies the dummy on that side when dummy symbols are looked for in 
(II) below. 
Subsequent to its definition, i£ a macro name Is encountered as a syllable (I.e. 

not part of any text argument nor in a macro definition) the following steps 

are performed: 

(I) the characters following the separator which ends 

the macro name are read as a list of arguments , 

separated by cenrca and the list ended by carriage 
return or semicolon. This process r termed the 
argument scan , associates In order each dummy symbol in 
the define line of the macroinstruction with the 
corresponding argument in the argument list. If 
in the define line a dummy symbol is ended by /, 
the scan for its argument is not terminated by 
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coc=;t (which In thi* case is treated, tiaply as 
another character in the argent), but by any 
^ character; if there are dumy symbols to the 
right of the /, the $can assumes that their 
arguments are not expressed The number of arguments 
read will in an/ case not exceed the number of 
dumy svc&ois in the macro definition/ Furthermore t 
if the first character where an argument is 
expecced i$ [ (open bracket)* that argucuut will 
consist of ell characters following the [, up 
to the Hatching J; the next argument (if £fty) 
should follow the ] immediately without $r. Inter- 
vening coc-ma. (Right bracket is matched only by 
left bracket.) Neither outermost bracket is passed 
on as part of the argument. Also if the first 
character where *n argument is expected is \ 
(backslash) j the subsequent characters up to 
but not including the first space or comma are 
interpreted as a field > and for the argument is 
supplied a string of digits expressing the value 
or the word {as an integer) in the Current Radix; 
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the next argument immediately follows the space 
or coflio* which ended the field. If fewer arguments 
are expressed than there are dummy symbols > the 
arguments given are associated with the leftmost 
dummy symbols, and the unsatisfied dummy symbols 
are given string vslues according to the following 
rules: 

1) If there is no / or \ in the list of dusxiy 
symbols in the define line, oil unsatisfied 

dummy symbols get the null string value. 

2) If chore is one or more / or \ in the list 
Of dummy symbols ift the define line, a.: 
unsatisfied dummy symbols which appear to 
the left of the first / or \ get the null 
string value, and all unsatisfied du^ray 
symbols to the right of the first / or \ 
are given a string value of the form 
cmill or GffllffiU, etc. (called a generated 
symbol ; a unique generated symbol being 
assigned to each such dummy symbol of each 
use of any such macroinstruction. 
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(II) The effect to the assembler is that the macro name 
and argument list are replaced by the body of the 
definition of that microinstruction, with each 
dummy symbol in the body receiving the string value 
of the corresponding argument* 

For example , if MAC is defined 35 follows 

DEFINE wMAC ^ E,F^ 
— , >IM0VEI^ E,3 £ 
— >| MULB V E,F^ 
TERMIH 

then MAC i , LOC will be seen by the assembler as 

-*| MOVEI wl>3^ 
_>j IMULB ^ J OOCJ 



If the argument scan is terminated by the presence of a semicolon, that 
semicolon (as well as what follows it) is passed on to the assembler after 
the macroinstruction body. 

The character 1 may be used to delimit dummy symbols when the effect of any 
other syllable separator is not wanted. The definition 

DEFINE HAC M.E.Fji 

-#l MOVEI «E,3^ 

-51 IMULlH w E,Fi 
TERM IN 

enables one to then say HAC W B, 1 ,LOC to generate 

-Jl MOVEI vl .3(i. 
-WlMULB^l.LOCj. 

or HAC w P 1 ,LOC ro give 

-*1M0VBI w 1 ,3 
-*|IHUL w 1 ,LOC 
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since the first argument , which extends from the space ending HAC to the next 

conrndj is null. Notice that only the single character just to the right of 

the macro name is lost; HAC ww > 1 >LOC h * s a first argument consisting of 

one space. 

A contton use of \ preceding an argument is as follows: 

DEFINE*0IS PATCH >K,TAB 

JRSUAB1N 
TERMIH 

--1 

REPEAT 30, [DISPATCH \.RPCNT+1,DT 

JRST DTI 
producing JRST DT2 

■ 

JRST DT0 

The argument brackets [) are often used to pass on argument lists to a macro or IRP 
within the definition of the macro being called: 

DEFINE tUPLIST FN.L 

IRP A,,[L] 

HAPONE FN, A 

TERMIN 
TERMIN 



DEFINE MAPOXE F.AL 

F v AL 
TERMIN 



KAPLIST MAC.ffl ,WCl,[l,L0Kj,[2,LCGiJ 

MAPONE NACiC i.LOC] 
MAPOKE KAC,(i,LOXj 
MAPCIIE MAC, [2, LOG 1 

MAC i.LOC 
MAC l.IOK 
HAC 2 ,1.00 
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The pseudoobstruction * QUOTE takes the symbol following and passes it on 
unchanged, protecting it from being taken as a dumzy symbol or as either of 
the pseudoinstructions DEFINE and TERttXN. In all other c^ses, & name which 
is currently a dummy symbol will appear to be replaced by its string value? 
whenever it appears bounded on each side by non-syllable constituents. For 
example, i£ A 1ft an accumulator as veil as z dummy symbol within a macro 
definition, on* might need to say 

ADD ^ .QDOTS^A,A 
to differentiate the two meanings* 



.TAGaname'? may be used within the range of IRP, IRPS or IRPC; or in the 
.GOAnameP body of a macro definition. Only the first 6 characters of 
the nace are used. The .TAG has no effect except tc nark 
a place in the LRP etc. or macro which may be referred to 
by a .GO . As one of these repeats or a macro Is being 
processed, sending characters to the assembler, when a 
.GO ia encountered it is not output nor does outputting 
resume right after the .GO ; instead, the range of the 
repeat (or body of the macro) in which the .GO occurred 
is searched for a .TAG with the matching name. If it is 
found, outputting to the assembler resumes to the right 
of the tag. If it is not found, processing of the current 
repeat or macro is terminated and processing returns to the 
point just beyond the range of the repeat or just after 
the macro usage; if this is within an outer repeat or macro 
body, searching for the missing tag Is done therein, etc., 
±£ a tag is not found anywhere until processing reaches the 
top level (outside all repeats and macro calls), assembling 
then resunses from the point just after the outermost 
repeat or macro. 
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.GSSET^no) Sets generated-syrnbol counter to value of no . 

PSgJBCIMSTyJCTIOSS ?A" :v: 

Binary Output Formats, 

Storage words are output in one of two modes: absolute or relocatable. 
There arc three possible formats for absolute output t named Read-in node, 
Half-word read-in mode, and staple block forages; there is one relocatable 
format* The Read- In node format , if punched on paper cape, can be read dv the 

RIM Loader (at 20); the staple block format, if on DECtape, can be read by 
MACDHP, or HACTRU (the DDT in time sharing) and on paper tape is preceded by a 
SBLK loader in RDf format: the i^lacAtabJ* frarxar can be read by the linking 

loader- Virtual quantities p and scrorage words with non-zero relocation, may 
not occur in absolute mode output, 

'--- ■ selects read-in mode format output 

SIMli selects half-word read-in mode format output 

S3LK*t selects simple block format output 

RELOCA^ selects relocatable format output and sets 

current location counter to with relocation J * 

lPASSj like RELOCA, but also causes a i-pass assembly. 

SBLK is initially selected, 

•SLDR causes Output of SBLK loader and enters S3L-K format 

WORD &wrd£, The value or wrd is output as a 36-bit word. In 

• , relocatable and sinple block formats, which output 

storage words in blocks, any block currently 
being accumulated is immediately output so that 
J/IXA appears in the proper place and between blocks* 
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n:.^y:i ! -. 



Suppresses output of symbol table which noroally 
accompanies binary program. 



.NSTGW 

.YSTGW 
Loader Commands, 



enables SWD error printout to occur if a storage 
word is generated. 

disables SWD error printout- .YSTGW is 
initially selected. 



In relocatable format, certain pseudoinstructions sre available to causa special 
action by the Linking Loader when encountered. 



♦LIBRA ^ namcli$tj> 



pLIFS^, mm list ^ 
,ELDC & 



This must occur before any storage words* It 
tells the loader that the program to follow is 
a library program * The entries in the namelis 
separated by commas, are either names or group 
nacres .separated by space, +, and »* An entry 
said to bo satisfied by s list of symbols If 
either (a) the entry is a name and that nam* a 
in the list of symbols; or (b) the entry is a 
of naras, all of which naoes preceded by space 
are in the list of symbols, and none of which 
preceded by - are. The Linking Loader will on: 
load a library program unless one or more entr 
its nameiist are satisfied by the list of unde 
global symbols used in programs alresdy loaded. 



i > 
s Of 

is 

ppaars 
group 
or *f 
aai&es 
it to 
ies in 
fined 



Load if Seen. 

End Load Time Conditional. Any storage words 
appearing between ,LIFS and .ELDC are passed on 
to Che loader which will load them only if or.e or 
more entries in the name list are satisfied by the 
list of defined and undefined global symbols used 
in programs already loaded. 

Note: .ELDC should always be followed by a locstion 
assignment (LOC pseudoinstruction). Sooetic^s i£ 
there is a series of load-time conditionals with no 
intervening non-conditional matter the LOC need 
only be used after the last. Notice that LCc $." 
may be used to continue loading storage words 
into subsequent locations where the effect of the 
losd-time conditionals is not necessarily known. 
Load Time Conditionals may be nested. 
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.LIFE & word ^ \ 
,LIFLE C word}, 

♦ LXFL £ word> 
,LIFG iword^ 

♦LIFCE & word^ 

• LIFN A word^, y 



Load Tisie Conditionals on Value. Any one of 
these starts a range which is ended by .ELDC. 
In each case the word is evaluated by the Loader, 
and the storage words in the range arc loaded 
only if the value of word is respectively 



.L:\KOT 



L0Rifl6f26f3 4 i 



if output is relocatable format, causes 
icaaediate output of all accumulated linking 
pointers. 

like .OP, but occurs when encountered by 
loader in relocatable format. <fl is an 
Instruction, f2 is taken as the contents of 
the specified accumulator, and f3 aa the 
contents of the specified memory location). 
Has no value; loader sets variable .LVAL1 
to resultant accumulator content, and .LVAL2 
to resultant memory contents. (Initially, 
■LVAL1 and .LVAL2 have the value 0). 

has same effect aa appearance of each name 
followed by a "> but generates no storage 
words. 

will output the given names to the relocatable 
loader such that the loader "sees" them in this 
program when queried by load- time conditionals. 
No definition is given to the loader, and a use 
of .LIBRE does not cause the names to be seen 
at all by the assembler * 



ERROR MESSAGES 

An error message typed out by MIDAS is in the following form: 

SYH+NN MHM L XXX CCC 



.GLQBMnaml Anam2 , , .J 



• LlBRQAnaml Anam2. . 
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SYX+NN is the current location in terms of symbols; MtfM is the current location 
in octal; L is the depth in macro-instructions; XXX is the offending syllable 
(if any); CCC is a 3-character error code, as listed below. A dagger t in the 
following listing marks a fatal error, which KIDAS will not proceed past, 

(All undefined sjrabol errors tre3t the symbol as having value 0, relocation 0] 

USW undefined symbol in a storage word 

USC undefined symbol in o constant word 

USP undefined symbol in a para&eter assignment 

(to right of =) 

USK undefined symbol in count field of REPEAT 

UCD undefined symbol in test field of conditional 

assembly 

USE undefined symbol in END pscudoinstruction 

USL undefined symbol in LOC pseudoinstruction 

USB undefined symbol in BLOCK pseudoinstruction 

USS undefined symbol in numeric field of SQUOZE 

pseudoinstruction 

USM undefined symbol in field following \ in 

microinstruction argument 

USO undefined symbol in OFFSET pseudoinstruction 

KDT multiply defined tag. A variable > defined symbol 

or macroinstruction appeared to the 
left of : end was not redefined, 

XDV multiply defined variable. A defined symbol or 

macroinstruction appeared followed 
by ' , and was NO? redefined. 

RES reserved. An attempt was made to redefine a 

pseudoinstruction. It was KOT redefined. 
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Ill illegal tag. Southing other than 3 synbol appeared 

to the left of : and no action was taken. 

IPA Illegal parameter assignment. Something other than 

a symbol appeared to the left of = and 
no action was taken* 

QPA questionable parameter assignment. A caacro aaaie 

or pseudoinstruction appeared to the 
left of = and WAS redefined. 

IEQ illegal EQUALS. One of the arguments was not a 

name, no action was taken. 



MGT multiply defined tag at virtual location. 

N6B not sixbic. A non-printing character appeared in 

the text argument of SIXBIT or to the 
right of ' . 

EPO exponent overflow. Floating point Dumber too large. 

X$G lost significance. Fixed point number coo large. 

VY:[ unused format of fields in a word. The word 

is taken as 0, 

StfD (turned on by .NSTCT) storage word generated. 

NOS no separator. AC3)C or ASCII /X/3, for instance. 

ILC illegal closing. Attempt to macch ( with ] or 

[ with > 

ILA virtual quantity used in absolute assembly 

IRA non-2ero relocation used in absolute assembly 

IRL illegal relocation. A field with relocation 1 

was put other than with its right end 
between bits 17 and 18 or 35 and 36. 
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! i,:; 



IGS 



IMY 
IDV 
PHI 

CLI 

LAI 

tTCA 

tTVA 



illegal relocation count- A field had a relocation 
other than + J or 0. 

Illegal virtual. A virtual -quantity was put 

other than with its right end between 
bits 12 and 13, 17 and 18» 30 and 31, 
or 35 and 36. 

illegal multiplication of virtual quantities 

division by virtual quantity 

• used when location indefinite, assumed 

: used at indefinite location 

location assignment contains illegal relocation 

too many constant word areas 

too many variable areas 



TCLD 
iVLB 

tVRD 

CRI 
•HHA 

yma 

TMCE 
tSCE 

«A£ 



too many constant words in one area 

constant word area location differs from 
previous pass 

variable are* location differs frca preview p iiS 

relocation of constant word area differs ir^m 
previous pass 

relocation of variable *rea differs from previous 
pass 

relocation of constant word area illegal 

coo many durmny symbols in macro definition 

too much argu~*en~s (strings too long) at use 
of tnacroinstruction 

microinstruction capacity exceeded 

storage capacity exceeded 

illegal format. Programmer's intent unclear. 

internal assembler error 

assembler made illegal memory reference 
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0?ERATIKG I >tST AUCTIONS NON TIMESHARING 

With HACSMP, load from the KACDMP SYSTEM tape the dump-mode file MIDAS. 
(There snay exist also a file MIDAS SEW. It snay have new features, or fix 
errors in old. Its use for assemblies instead of the MIDAS file vould be 
appreciated as an in vivo check-out of the new version.) When MIDAS is started, 
it will accept a string of commands froa the on-line Teletype, ended by two 
successive ALTHODE characters* The effect is the saw whether all the corjnands 
are in one string or they are each in a separate string delimited by ALT MODES. 

(($) will be used as a symbol for ALT MODE.) In normal use, one should give 
commands in the following order: (1) select an input file; (2) select an 
output medium; (3) direct the assembly; (4> file the output (numbers (I) and 

(2) may be interchanged). 

(1) Input Selection; the command nERnanel w na»2 © 
will select for input the file named mz&l nase2 
or the DECtapc on unit n. If the ER command is 
not given, input is selected from the paper tape 
reader or on-line teletype. (The reader is checked 
initially, and after each character is typed in.) 

(2) Output Selection: the command raEI will select for 
output on the DECtspe on unit m. If the SI coraisnd 
is not given, output will be on paper tape. 
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(3) Assembly; the cccciand A causes the prograa to 

be assembled. This is the corrcand normally used; 
It is composed of five parts which can be commanded 
separately, la order, these are 

I initialize. Forget all symbols, macros, etc* 

except those in the Initial Symbol Table; 
set the Current Radix to 8; set the Current 
Location Counter to 103 with relocation (S; 
ielect SBLK output format; clear all fnput and 
output buffers . 
pass one* Read Che input file and ssse^ble 

it, defining symbolo and macros, developing 

values of storege words, etc. No output is 
done unless the iPASS pseudoinstrwczion wss 
used in the program. 

S punch SEUC loader if S3LX is output fornst. 

T pass two. If iPASS was not used, retd 

the input file and assemble it, ouc put ting 
storage vords (and in the relocatable format, 
various data concerning virtual usages) to 
the output device previously selected. If 
PASSi was used, do none of this bet instead 
check if any symbols vere used which are 
Still undefined* 
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L symbols, Output a sycbal table (unless 

NOSYMS was used). 
(4) Output Filing: the cornmand EF name! w name 2 (§} 

will file DECtape output in SBLK »ode for 
absolute-mode output or REIOC mode for 
relocatable mode output. There is no need 
for this if output was to paper tape, or if 
: the asaecbled program is not going to be usee 

(for instance, due to a large number of 
assembly errors). 
When one program has been assembled, another may be without reloading MIDAS, 
To leave KIDAS and return to MACDMP, use the command B* 



There arc also several characters which may be typed in and take effect 
immediately, without being part of command strings* These are various letters 
with the CTRL key hold: 



u 

12 

ic 

IS 

Is 

IS 



(bell) 



type out all input characters processed by HIDAS* 
This includes expansions of macros, IRP, etc, 

turn off typeout. 

Quit current activities znd wait for Uyped-in 
commands. It is advisable to go to MACI&P and 
load a fresh MIDAS if you have Quit* 

Turn on line printer output* 

Turn off line printer output* 

Commence output to paper tape. 

Cease paper-tape output* 
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UC Commence BECtape output, 

ty Cease output to EECtape. 

«j resune reading from DECt3pe H 

IS Interrupt reading DECtape. 



OPRRATTHfi INSTRUCTIONS TIME _SHAR1HG 

To DDT type MIDAS \l^ (alternatively, any other commands which will load 
and start the program TS MIDAS on device SYS), Into MIDAS type a command 
line comprised of (a) the destination file designation; (b) the character 
*- (shift 0); (c) the source file designation; <d) a carriage return, A 
file designation consists of: a) (optional) a "system name" ended by 
; (semicolon)- If no system is specified, the na»e the user gave as he 
logged in is assumed, b) a device name ended by i (colon), c) the file 
name consisting of two subnames separated by a space* If a system name 
or device name is not specified in the destination description, the 
name used in the source description will be taken. If no file name is 
given in the destination description, one will be assumed whose first 
subname is the first subnarne of the source file, and whose second subname 
is BIN. When the carriage return is typed, MIDAS will read the 
designated source file, and output the assembled result and file it 
accordingly to the destination file designation. The title (on each 
pass), PRINTX output, etc. and error messages will appear on the user's 
console. When finished, MIDAS will do a Value Return to DDT, 
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tedlx-50 SQXZS Co<tc 



This is the form ia which symbol names are represented internally and in symbol 
tabic output- 



Character 


Valuo(octal) 


Character 


VaUe(octsl) 


null 


9 


J 


24 


1 


1 


K 


25 


1 


2 


L 


26 


2 


3 


M 


27 


3 


4 


N 


30 


6 

■ ■ 


5 





31 


5 


6 


P 


32 


6 


7 


Q 


33; 


7 


10- 


a 


34 


9 


11 


s 


35 


9 


12 


T 


36 


A 


13 


U 


37 


B 


14 


V 


40 


C 


15 


w 


41 


D 


16 


X 


42 


E 


17 


V 


43 


F 


20 


z 


44 


G 


21 


* 


45 


H 


22 


$ 


46 


X 


23 


°/o 


47 
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Say the naifte is ABCDEF; the Squoze code Is 

20 + 50 * <17 + 50 * <l& + 50 *<I5 + 50.* <14 + 30 * i3»», 
i.e. the last character is least significant in Chtt radix-50 (octal) repvesen* 
tat Ion, If the name has fever than 6 characters, the lest characters arc 
taken as null. 

The radix-50 scheme leaves 4 free bits sC Che high-order end of £ 36-bit 
word; these are used as Code 3it* to describe the type and relocation o£ the 
symbol. 
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Symbol 



1PASS 

AM 

ADDB 

ADDI 

ADXfrl 

AND 

A3CDB 

A3DCA 

AK3CAB 

AKDCAI 

AKDCAM 

AttDCB 

ANDCBB 

'.KECBI 

AKDCBM 

ANDCM 

AKDCKB 

ASDCXI 

ANDCMM 

AEDI 

AKEM 

AOBJS 

AOBJP 

CAI 

CAIA 

CAIE 

CAIG 

CAIGE 

CAIL 

CAUE 



CAIS 
CAM 



QUIA 
CAME 



Initial Symbol Table 




Value 


Symbol 


Val ue 


(octal) 




(octal) 


pseud o 


AOJ 


(340000) 


(27(11*00) 


AOJA 


(344000) 


(273500) 


AOJE 


(342000) 


(27103(3) 


AOJG 


(347000) 


(272000) 


AOJGE 


(3450*0) 


(404W0) 


AOJL 


(341000) 


(437000) 


AOS 


(350000) 


(410000) 


AOSA 


(354000) 


(413000) 


AOSE 


(352000) 


(411000) 


AOfG 


(357000) 


(412000) 


AOSGE 


(355080) 


(440000) 


AOSL 


(351000) 


(443000) 


AOSLE 


(353000) 


(441005) 


AOSH 


(356V>00) 


(442000) 


APR 





(420000) 


ASCII 
ASCI? 


pseudo 
pseudo 


(423000) 


ASH 


(240000) 


(421000) 


ASHC 


(244000) 


(422000) 


BUCI 


(700000) pseudo 


(405000) 


AOJLE 


(343000) 


(406000) 


ACJK 


(346000) 


(253000) 


5LK0 


(700100) pseudo 




BLOCK 


pseudo 


(252000) 


EL? 


(251000) 


om-m 


CONSZ 


(700300) pseudo 


(304000) 


ca 


114 


(302000) 


DATAI 


(700040) pseudo 


(307000) 


DATAO 


(700140) pseudo 


(305000) 


DC 


200 


(301000) 


DCSA 


300 


(303000) 


DCSB 


304 




DECIMA 


pseudo 




DEFINE 


pseudo 


(306000) 


CIS 


130 


(310000) 


DIV 


(234000) 




DIVB 


(237000) 




DIVI 


(235000) 


(314000) 


DIVM 


(236000) 


(312000) 


DP3 


(137000) 




DPBI 


(136000) 
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Symbol 

CAKG 

CAMGE 

CAML 

CAMLB 

CAKH 

CLEAR 

CLSARB 

CLEARI 

CLEABM 

COI.'I 

CCNO 

ca;so 

COWSXA 



FAER 

F/.DAB 

FASXL 

PADBK 

FDV 

FDVB 

FDVL 

FDV.'i 

psva 

PDVRB 

FDVRL 
F2VRM 
FMS 

Fit 3 

7. '. 

FMPM 

FM?a 

FK?RB 

FKPRL 

FM?3M 

FSB 

F£33 

FS3L 



HLRS 
HLREI 
HLSEK 
HL32S 

:.;:.: 

HLSM 
KLEO 
EL&.OI 



(317523) 
{315030; 
(311000) 
(313050) 

(3:t"'^> 

(433000) 

(403000) 
(601 300) 

(402300) 

(700240)psciido 

(700250)pscudo 

( 70534 0)p se udo 
pscudo 



(147003) 

(145000) 

(146000) 

(170003) 

(173000) 

(171000) 

(172002) 

(174000) 

(177000) 

(175053) 

(176000) 

(160000) 

(163000) 

(161000) 

(152020) 

(164003) 
(167^00) 

(165000) 
(166000) 
(150^00) 
(153000) 
(1510 00) 
7J72^0*0J" 
(575000) 
(576000) 
(577J00) 
(545000) 
(546000) 
(564500) 
(565000) 



Syinhol 

E1CD 

EQUALS 

EQV 

EQVB 

EQVI 

EQVM 

EXCii 

EXP 

EXPIMC 

FAD 

FADB 

FADL 

FABM 



FSBH 

FS3R 

FSBRB 

?S3KL 

F£3SM 

FSC 

HLL 

KILE 

KLLEI 

KLLEM 

HOBS 

HLLI 

HLLM 

HLLC 

HLLOI 

HLLOK 

HLLOS 

HLL3 

HLL2 

HLLZI 

HLLZM 

tiLLZS 



C.aLOI 

HRLOH 

HRLOS 

KRLS 

KitiZ 

HR1JI 

HRUM 

il&LZZ 



Vfiiufl 



pseuco 
pa cud 5 
(444; ■■;.; 

(WW) 

(4451 ;:) 

(446PS0) 

(2500;-0) 

pseudo 

pecudo 

(14000?) 

(143000) 

(141000) 

(142020) 



(152600) 
(154000) 
(15700?) 

(I550S5) 
(156503) 
(132003) 
(500000) 
(530000) 
(531000) 
(532000) 
(533000) 
(501000) 
(5U2000) 
(520003) 
(521000) 
(522000) 
(523000) 
(503000) 
(510000) 
(511000) 
(512000) 
(51 30G0) 
(54400?) 



(526003) 

(527000) 
(5070r>?\ 

(5l40iiO) 

(515.300) 
(S16003) 
(5 I 7£00) 
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Symbol 

HUtOH 

HLROS 

liLRS 

HLRZ 

)1LRZI 

HLRZM 

HLR2S 

HRL 

HRLE 

1IRLEI 

KRiEM 

KRLES 

KRLI 

?RLH 

HRLO 



HRRZS 

IBP 
ID IV 

IDIV3 

IDIVI 

IMVM 

JDPB 

IFI 

IF2 

IFE 

IFG 

IFGS 

IFL 

IFLE 

in; 

IPSE 
IFSK 
ILDQ 

IKUL 

IMUL3 

■:.:;■:.; 
IKULM 

:oa 



Value 



(566030) 

(554000) 
(555000) 

(557000) 
(504000) 

(534000) 
(535000) 
(536000) 
(537000) 
(505000} 
(5^6000) 
(52400 0? 



KOVEH 
KOTOS 

hqvk 



(553000) 

(1 33000) 

(230030) 

(233000) 
(231000) 
(232000) 
(136000) 
pseudo 

pscudo 
pseudo 
pseudo 
pseudo 
pseudo 
pseudo 
pscudo 
pseudo 
(134000) 



(2 



(223033) 
(221000) 
(222000) 
(4340 00 



Symbol 

ERR 

HSSE 

KRREI 

HRREX 

KRRES 

RRRI 

KRBH 

KRRO 

NRROI 

HRSOM 

HRROS 

KRRS 

HRRZ 

HRRZI 

K3R2K 



I0R2 
I0BM 

zap 

IRPC 
IRPS 

jfcl 

JRA 

JRST 

JSA 

JSP 

JSR 

.; lK? 

JUMPA 

JUMPS 

JUMPG 

JTJKPGE 

JUKPL 

JUXPLE 

JUMPS 

LDB 

LDBI 

LPT 

LOC 

LSH 

LSHC 

MOVE 

MOTE I 



) 

(203000) 
(214000) 



POP 

POPJ 

PRIKTC 



Value 

(56 0000; 

(570Q00) 
(571000; 
(572000) 
(5730£$) 

(541 W9) 
(542000) 
(560000) 
(561000) 
(562000) 
(563003) 
(5430?0) 
(550002) 
(551000) 
(552000) 

(435000) 

(ft 36030) 
pseudo 
pseudo 
pseudo 
(2550E0) 
(267000) 
(254000) 
(266000) 
(265000) 
(264000) 
(320000) 
(324000) 
(322050) 
(327000) 
(325000) 
(321003) 
(323000) 
(326000) 
(135020) 
(134000) 
124 

p seudo 
(242000) 
(246003) 
(200000) 
_(201000) 
(262000) 
(263000) 
pseudo 



Syabol 



Value 



Symbol 



Value 



VJWl'J. 


(215000) 


SK1PA 


(334000) 


:-:ov:c: 


(216000) 


SIUPE 


(332000) 


MOVHS 


(217000) 

L > I]] | \ 


SKIPG 


(337000) 


KOTO 


UldtVV'J 

i • • * -■ 4 j* \ 


SKIPGE 


(335000) 


WOVKI 

>»VN>S 

>*3VHS 

MOVS 

HDVSI 


(2110M) 
(212000) 
< 213006) 

(20i&ee) 

(205000) 


TDC 

TDCA 

TDCE 

PRINT* 


(650000) 
(654000) 
(652000) 

pSfiUdC 


HOVSM 


(206000) 


PTP 


iSS 


MUL 


(224000) 


PTR 


104 






'■VSY. 


(26lfl ., 


HILB 


(227000) 


PUSHJ 


iz6t>m) 


MULl 


(225000) 


RADIX 


pseuds 


HULM 


(226000) 


REIOCA 


pseuds 


KOSYMS 


pseudo 


REPEAT 


pseud a 


NULL 


pseud o 


RM 


pseudc 


OCTAL 


pseudo 


RDil 


pseudo 


OFFSET 


pseudo 


ROT 


(2413&3) 


ORCA 


(454000) 


ROTC 


(245033) 


ORCAB 


(457000) 


SBLK 


pseudo 


ORCA I 


(455000) 


SETA 


(424000) 


ORCAM 


(456000) 


S2TAB 


(427000) 


ORGS 


(470000) 


SETAI 

l 


(425000) 


ORCBB 


(473000) 


S2TAK 


(4260£0) 


ORCBI 


(471000) 


SETCA 


(45(&iStf): 


ORCBM 


(472000) 


SETCAB 


(453000) 


ORHM 


(464000) 


S3TCAI 


(451000) 


ORCMB 


(467000) 


SIUPL 


xssmfi 


ORCMI 


(465000) 


SKIP LB 


(333323) 


ORCMM 


(466000) 


SKIPN 


(336303) 


?1 


4 


SOJ 


<36WW) 


SETCAM 


(452000) 


SQJA 


(364000) 


SETCM 


(460000) 


SOJE 


(362000) 


SETCMB 


(463000) 


SOJG 


(367000) 


SETCMI 


(461000) 


SOIGE 


(365000) 


SETCMM 


(462000) ... 


SOJL 


(361030) 


SETM 


(414000) 


SOJLE 


(3650S3) 


SETMB 


(417000) 


SQJN 


(366303) 


SETMI 


(415000) 


SOS 


(370303) 


SETMM 


(416000) 


SOSA 


(374030) 


SETO 


(474000) 


SOSE 


(372000) 


SETOB 


(477000) 


SOSG 


(377000) 


SETOI 


(475000) 


SOSGE 


(375000) 


SETOM 


(476000) 


SOSL 


(371000) 


SET? . . 


(400000) 


SOSLE 


(373003) 


SETZB 


(403000) 


SOSX 


(376030) 


SETZI 


(401000) 


SQ'JOZE 


pseudo 


SETZM 


(402000) 


SUB 


(274000) 


SIXBIT 


pseudo 


SUB3 


(277330) 


SKIP 


(330008) 


SUB I 


(275000) 






su-;:-'. 


(276000) 


1 ■ "■* ~ -■ 




TlUA 


(605000) 






TUIE 


(603333) 






mm 


(607303) 



HOTBJ 
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Symbol 

TDK 

TWA 

Ti>NE 

TWN 

TM 

TBOA 

?K>E 

T&s 

TDZA 
TSZS 
TKS 
TER3IH 

TIC 

7LCA 

TICE 

TICK 

TIN 



TSZ 

TKA 

TE2E 

_rz:> 

TSC 

TSCA 

TSCE 

TSCS 

tee 

TOW 

TSHB 

T£0 

TSOA 

TSOE 
130!i 
*S£ 

ISZE 
TSZN 
TTSf 
THE 

UTC 



V«ii 



L1C 



(612MS) 
(6 1600?) 

£67£0(i3> 

(67«PW> 
<6 30000) 

(632023) 

<63«0«) 

pseudo 

pseudo 

041000) 

(645003) 

<647«0) 

/■.?.■.■,■■;,_ 
(£20004) 

(&220$1J) 
(M600*) 
(65 '.04! 3) 
(655003) 
(6530W) 
<S5700'J) 
(&U0W 
O150W) 
(61300tf> 
(*1700*) 
(471000) 
(675300) 

(673H0C) 
(677005) 
(*31W« 
(635003) 
(633200) 
(6 3733 J) 

lift 
210 



7L0 

TLO£ 

T108 

ILZ 

TLZA 

K2Z 

2L28 

7ace 

TRCT 
TRN 
TR8A 
XRK£ 

TSO 

530A 

TROE 



UTS 
VARIAB 

was 

XCT 
XOR 

XC>RI 

XDwa 

XWD 
XrfORD 

-ASCII 

.BEGIN 

.tm 

.7NAM1 

-FORMA 

.CUWA 

-CO 

.GSSKT 

•II8RQ 

.LNKf)T 

•tor 

♦KSTCU 
.TAG 
.TYPE 
TSTflW 



value 

(565/ .■■;. 
(663ffl) 
(66703*) 

(621W) 
(62^J3» 

(64««) 

(£660(10) 

(»WW»J 

C&6C03i) 
(6W303) 
(6620W) 



la the timesharing 
version there are a 
great aany addition: 
Initial symbols, * 
for axfiftipl*, Gveten 
calls* status bits 
etc. This list 
ctan&es frequently 
it accordance with 
the development of 
the rice-sharing 
system, so no 
accenpt has oeen 
made to include 
them her*. To Avoid 
conflict vith these 
symbols, bear in 
mind that each such 
fi^hrtl begins vith 
a period. 



2L4 
pseud o 
pseudo 

<431fflW) 
(432W8) 

pseudo 

pseudo 

Current Location 

pseudo 

pseudo 

pseudo 

pseudo 

pe*udo(t-e wl/) 

pseuio{t~s cftl/) 
pseudo 
pseudo 
piaudo _ . . 

p££Udo 

pseudo 
pseudo 
pseudo 
pflaudo 
pseudo 
pseudo 
pseudo 
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giftrrv rorc-ass 



aa (loaded by loader at 20) 

f DATAI PTR> ADDRESS 
(CONTENTS 
DATAI PTR> ADDRESS 

CONTENTS 
< JRST START 



ri>;1 












/KRRI 


17, 


RIGHIHALF 






j HRRM 


17, 


ADDRESS 






} KRRI 


17, 


LEFTHALF 






I HR1M 


17, 


ADDRESS 






KRRI 


17, 


RIGHTHALF 






HRRM 


17, 


ADDRESS 






KRRI 


17, 


LEFIHALF 






HRIH 


17, 


ADDRESS 






>JRST 
I 


START 
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S3LK 



(!) S31X loader It. RIM forest: Read Lefc-to-Riftht 

* numbers are octal * 



DATA I 


?TR,0 


DATAI 


PTR,i 


DAIAI 


P?R,2 


DATAI 


?TR 3 3 


DATAI 


PTE»4 


DATAI 


??R,5 


DATAI 


PIft*6 


DATAI 


?IR 3 7 


DATAI 


??R,I0 


DATAI 


PTR,U 


DATAI 


PTRjl2 


DATAI 


P?R,13 


DATAI 


PTR,30 


DATAI 


PTR>31 


DATA! 


PTR,32 


DATAI 


PTR,33 


DATAI 


?TR,34 


DATAI 


FIR, 35 


DATAI 


KTR»36 


J&ST 


1 



COKO PTR,S0 
JSP 14,30 
DATAI PTR.16 
MOVE 15,16 
JUHPGE 16,16 
JSP 14,30 
DATAI WR,(16> 
ROT 15,1 
ADD 15,(16) 
AOBJK 16,5 
MOVEI 14,33 
JBST 30 
COKSO PTR.10 
JRSTT 30 
JRST (14) 
DATAI ?TS,16 
CAMS 15,16 
JVMPA 1 
JRST 4 ,9 
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(2) Blocks read by SEUC Loader 



The checksum 
for each data 
block is 
computed as 
follows: cake 
the header 
word; rotate 
it to the 
left one bit 
2nd adc the 
first data 
word; rotate 
the result to 
the left one 
bit and add 
the second 
data word; etc. 
After the nth 
data word the 
result should 
equal the 
checksum. 



(»-n) first address 
contents of 1st addr. 
contents of (1st addr*+l) 

contents of (1st addr.+n-iV 



; header word 



n data 
words 



PROGRAM ( 



logical 




checksum 


block I 


punched 


any number of data blocks 

* 


blocks 




have 


i 


n <- 40' 


JRST start ; just block 


u^ — to start 






of program 
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The address 
in che header 
word of each 
data block 
of the symbol 
table should 
be ignored. 



5YM30L 
TABLE 



Notice that 
a JRS7 
instruction 
is positive. 



block 



SQUOZB+(040W0) 

value 
SQUO2E+(040000) 

value 
t 
# 

value 

checksum 

i 

4 

any number of blocks 

jrsV 



;hcadcr word 
1st symbol 



2nd symbol 



ci\th synbol 
2 



; end of symbols 
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Suggested Svr.bolic Format 

■ 

The format-free nature of the MIDAS symbolic language allows a great deal of 
typographic variety, but some of this variety should generally be given up 
for the sake of readability of one's program* The suggestions which follow 
are not hard-and-fast rules, but in most cases will represent a consensus as 
to good practice. 



(1) A storage word should appear on a line indented one tab stop* 

(2) An address tag (symbol followed by colon) should not be indented* 

■ 

(3) All address tags referring to a given location should appear on 
separate lines, with the contents of that location indented once 
on the same line as the last (or only) tag. 

(4) Blank lines (redundant carriage returns, line feeds, etc*) nay 
occur wherever useful to demarcate parts of a routine* 

(5) The entire typescript should be divided into pages (by form-feed 
characters). The logical divisions of the program should coincide 
with page divisions* Although a page will hold up to about 60. 
lines, it is good practice whenever convenient to put only 45* or 
50. lines per page. \ . 

<6) Within a storage word, use space rather than tab as a field delimiter. 

(7) Close all ( [ and < groups with ) ] and >. 

(8) When a comment is applied to a storage word, put one tab before the ;* 

(9) Pseudoinstructions and macro names which generate one or more storage 
words should generally be treated like storage words. 



*8. 



(10) EtfD and TITLE arc usually not indented. 

(11) With the possible exception of 0, accumulators should as a rule 
*ba referred to symbolically* with such symbols defined at the 

beginning of the prograa* 

(12) Generally it is a good idea Co put a parameter assignment (use of -) 
at the earliest: point in the program where its right side is defined. 



The following page is aft example of coding in the MIDAS language. (It is the 
first page of * program which uses the TV caoera.) It demonstrates cany, 
though by no means ail, of the features of MIDAS. The FIX macro is indeed a 
sequence of instructions which will convert a floating-point number to fixed** 
point* 



TITLE FIHQ THAT 8ALL 





RELOCA 


TABLE . 




KSCHM- 


2 




TVHCHN 


»3 




TVVCHH 


=U 


L 


TVCCHN 


"5 




TVA=?70 




MSC=7SO 


' 


LPDL a iOO 


' 


DEFINE 


BALLP N,NO 
SETCM Y,X 
JUMPE Y,NO 




REPEAT 


H-l, [ LSH 






ANDCM Y,X 




) 








JUMPE Y,NO 


1 




TLMN Y, 777000 






JRST .+5 






LSH Y,-ll 
TLO Y,O1100C 


; 




FSC Y,26 




TERM IN 


FAD Y,Y 
LSH Y,-27 




DEFINE 


FIX 




P"=l 


HUL1 X,(iO0 
TSC X,X 

ASH X*1,-2I»3(X) 
TERM IN 




Y" = i* 


;V 




T»-5 


;T 




X"-3 


;x 




D = 2 






£ = S 






DING: 


JRST I., THRU 




LOOK: 


SETOM LCK1 
SETOM LCK2 
CLEARM TAXP 
MOVE T,TAKN 
MOVEM T,TAK£NO 
CLEARM LETAKE 
CLEARM PNTSS 




- 


SETOM TVIOLE 




• 


SETOM CANCEL 
CLEARM KSTIME 
COf.'O MSCMSCHN 
JRST LOOKA 



K#l 



